# Yocto Linux

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# Overview

The Yocto Project (YP) is an open-source collaboration project that helps developers create custom Linux-based systems. Yocto can also be used to build systems for platforms designed based on Qualcomm SoCs. The following sections will introduce Yocto builds for the Quectel Pi H1 smart single-board computer designed based on Qualcomm's **QCS6490** SoC.

Quectel Pi H1 uses the SDK provided by Quectel based on the Yocto build system. This SDK is deeply customized and optimized for the Qualcomm platform, providing developers with complete BSP (Board Support Package) support.

# Supported distributions

Quectel Pi H1 currently supports the following Yocto distributions:

## Yocto Linux (qcom-wayland)

The official Yocto Linux version provided by Quectel is based on the Qualcomm **QCS6490** platform BSP, with integrated complete driver support and multimedia functionality.

**Main features:**

- Based on **Yocto Project** build system

- **DISTRO**: qcom-wayland

- **MACHINE**: qcm6490-idp

- Complete Qualcomm platform driver support

- Rich multimedia codec capabilities (supports 4K@60fps)

- Powerful AI computing support (up to 12 TOPS)

- Comprehensive peripheral interface support (USB, PCIe, MIPI, HDMI, etc.)

# Building Yocto Linux for Quectel Pi H1

## Prerequisites

Before starting the build, you need to:

1. **Configure development environment**  
Prepare an Ubuntu 22.04 LTS development host and install the necessary toolchain. For detailed environment configuration steps, please refer to:  
    - [Development environment setup](<Development environment setup/Development environment setup.md>)

2. **Hardware requirements**  
    - x86 computer (quad-core CPU or higher)  
    - At least 16 GB RAM  
    - At least 300 GB available disk space (SSD recommended)  
    - Ubuntu 22.04 (64-bit) operating system

## Build process

The complete Yocto Linux build process includes: code cloning, environment configuration, compilation, and packaging. After the build is complete, you can obtain complete firmware files including system images, kernel, and device tree.

**For detailed build steps and operation guides, please refer to:**

- [Image build](<Image build/Image build.md>) - Includes complete SDK acquisition, compilation, packaging, and image acquisition steps

**Note**  
Yocto builds are a complex process. The first build may take 1-2 hours or longer, depending on your hardware configuration and network conditions. It is recommended to use a high-performance computer and ensure a stable network connection.

# Image flashing

After the build is complete, you can use the QFIL tool to flash the image to **Quectel Pi H1**. For detailed flashing steps, please refer to:

- [Image flashing](<Image flashing/Image flashing.md>)

# Reference resources

- **Yocto Project official website**: [https://www.yoctoproject.org/](<https://www.yoctoproject.org/>)

- **Qualcomm Developer Website**: [https://www.qualcomm.com/developer](<https://www.qualcomm.com/developer>)

- **Quectel Technical Support**: Get more technical support related to Quectel Pi H1

# **Quick access**

- [Development environment setup](<Development environment setup/Development environment setup.md>)
- [Image build](<Image build/Image build.md>)
- [Image flashing](<Image flashing/Image flashing.md>)
- [Remote access](<Remote access/Remote access.md>)
- [System tools and applications](<System tools and applications/System tools and applications.md>)
- [Cross-Compilation toolchain](<Cross-Compilation toolchain/Cross-Compilation toolchain.md>)
- [Device tree file description](<Device tree file description/Device tree file description.md>)
- [Kernel compilation and update](<Kernel compilation and update/Kernel compilation and update.md>)
- [Add applications and third-party libraries](<Add applications and third-party libraries/Add applications and third-party libraries.md>)
- [Performance optimization techniques](<Performance optimization techniques/Performance optimization techniques.md>)
- [User Guide](<User Guide/User Guide.md>)